SIMPLE REPLICATOR 1.9 - After Effects
par Charles Lecoanet - lecoanet-design.com
Gratuit. Ne pas revendre ni redistribuer sous ton nom.
Mode d'emploi détaillé : « Simple Replicator - Mode d'emploi.pdf » dans ce dossier.
Detailed guide: "Simple Replicator - User Guide.pdf". Manual detallado: "Simple Replicator - Manual de uso.pdf".

==================================================================== FRANÇAIS

CONTENU DU PACK
  Simple_Replicator.jsx (le script), Startup/ (ouverture automatique, facultatif), les modes d'emploi PDF
  en français, anglais et espagnol, et Simple_Replicator_Sample_Project.aep : un exemple de chaque preset,
  chacun dans sa propre composition. Ouvre-le pour voir les réglages, puis sélectionne un nul.

INSTALLATION
1. Copie Simple_Replicator.jsx dans :
   Applications/Adobe After Effects <version>/Scripts/ScriptUI Panels/
2. Redémarre After Effects, puis Fenêtre > Simple_Replicator.jsx (panneau ancrable).
   Utilisation rapide : Fichier > Scripts > Exécuter le fichier de script...

LE PANNEAU
Trois onglets pour garder une petite fenêtre (le dernier onglet ouvert est retenu) :
  Créer ......... nouveau réplicateur (preset, forme, copies, options)
  Réplicateur ... nombre de copies, preset, attracteur, tracé, Figer / Dégeler, supprimer
  Réglages ...... tous les réglages du nul en direct, avec images clés
Après « Créer », le panneau passe tout seul sur l'onglet Réglages.

ROUVRIR LE PANNEAU
Installé dans ScriptUI Panels : Fenêtre > Simple_Replicator.jsx.
Lancé à la main : Fichier > Scripts > Fichiers de script récents.
Fermer le panneau ne supprime rien : tout est stocké dans le nul du réplicateur.

OUVERTURE AUTOMATIQUE
Panneau fermé : clique sur le nul « Replicator N Control » (ou une copie), le panneau se rouvre sur
l'onglet Réglages. Ça marche dès que le panneau a été ouvert une fois dans la session.
Pour que ça marche aussi juste après le lancement d'After Effects, copie
Startup/Simple_Replicator_AutoOpen.jsx dans Applications/Adobe After Effects <version>/Scripts/Startup/
puis redémarre After Effects.
Pour désactiver : décoche « Ouvrir ce panneau quand je sélectionne un réplicateur » (onglet Réplicateur).

CRÉER (onglet Créer)
1. Sélectionne un ou plusieurs calques : métrage, précomp, texte, forme ou modèle 3D (GLB/OBJ, AE 2024+).
2. Choisis la forme et le nombre de copies, puis clique sur « Créer le réplicateur ».
3. Le script crée le nul « Replicator 1 Control » et les copies (cachées dans les calques discrets).
   Les sources sont masquées (œil éteint), pas supprimées.
4. Tout se règle EN DIRECT dans les effets du nul. Déplace, tourne ou mets le nul à l'échelle
   pour déplacer toute la formation. Ajoute une caméra 3D pour naviguer dedans.

PRESETS
Choisis un preset dans la liste « Preset » : la forme et un nombre de copies conseillé se remplissent.
Clique sur « Créer » pour un nouveau réplicateur, ou choisis-le dans l'onglet Réplicateur et clique sur
« Appliquer le preset » pour le réplicateur sélectionné (son nombre de copies ne change pas).
  Galaxie tournante ...... galaxie à 3 bras qui tourne, tailles et opacités variées, dégradé de couleur
  Mur d'images ........... grille qui apparaît depuis le centre en arrivant de la caméra
  Planète de particules .. sphère qui tourne, petites copies face caméra
  Carrousel .............. anneau incliné qui tourne, copies face caméra (idéal avec 8 à 16 images)
  Tornade ................ hélice haute qui tourne vite avec turbulence
  Nuage flottant ......... volume aléatoire qui dérive lentement, copies qui tournent sur elles-mêmes
  Explosion .............. sphère : Radius et Random Position partent de 0, toutes les copies partent du même point
  Vague .................. grille inclinée ondulée par la turbulence
  Flux sur tracé ......... copies qui défilent en boucle le long d'un tracé (lie un tracé ensuite)
  Essaim + attracteur .... essaim agité + attracteur créé automatiquement : anime le nul attracteur
  Réinitialiser .......... remet les réglages par défaut en gardant la forme
Un preset remet les autres réglages à zéro (images clés comprises) et règle la rotation du nul,
sauf si elle est animée. Il ne touche pas aux colonnes et rangées, au tracé, à l'attracteur,
aux couleurs ni à la valeur Seed.

ONGLET « RÉGLAGES »
Il reprend tous les réglages du nul, rangés en onglets :
Animation, Forme, Variations, Apparition, Couleur.
- Sélectionne le nul (ou une copie) d'un réplicateur : le panneau le charge tout seul, même un
  réplicateur créé avant, après avoir fermé et rouvert le panneau ou rouvert le projet.
  S'il n'y a qu'un réplicateur dans la comp, il est chargé sans rien sélectionner.
  « Charger le réplicateur sélectionné » force la relecture des valeurs.
- Si le titre indique « figé », clique sur Dégeler (onglet Réplicateur) pour pouvoir le modifier.
- Bouge un curseur ou tape une valeur : le nul change aussitôt. Une seule annulation (Cmd+Z) par changement.
- ◆ ajoute une image clé à l'instant courant avec la valeur affichée. Pour animer : place la tête de
  lecture, règle la valeur, clique sur ◆, puis recommence plus loin.
- Si le réglage a déjà des images clés (◆ après son nom), changer la valeur crée ou modifie la clé
  à l'instant courant.
- × supprime toutes les images clés du réglage et garde la valeur affichée.
- Les réglages sans effet sont grisés : par exemple Colonnes / Rangées hors grille, Bras hors galaxie,
  Axe de rotation quand la formation ne tourne pas, Fréquence et Vitesse sans turbulence, Force et
  Rayon de l'attracteur sans attracteur, les réglages d'apparition sans Apparition, les couleurs sans
  Coloriser. Ils se réactivent dès que tu changes la forme ou le réglage qui les commande.
- En mode léger, si tu actives depuis le panneau un réglage absent des copies (rotation, échelle,
  opacité, apparition, Face Camera, couleur), le script recrée les copies tout seul.
- Le panneau affiche les valeurs à l'instant courant : après avoir déplacé la tête de lecture sur un
  réglage animé, clique de nouveau sur « Charger ».

RÉGLAGES DU NUL
Forme
  Shape ............... Grid, Sphere, Circle, Helix, Line, Random Box, Galaxy, Path
  Columns / Rows ...... grille (les couches en profondeur se créent toutes seules)
  Spacing ............. écart grille / ligne (px)
  Radius .............. rayon sphère, cercle, hélice, galaxie, demi-taille de la boîte
  Height .............. hauteur de l'hélice, épaisseur de la galaxie
  Turns ............... tours de l'hélice, torsion des bras de la galaxie
  (galaxie : avec Formation Spin positif, elle tourne dans le sens horaire, les bras traînent derrière)
  Arms ................ nombre de bras de la galaxie
  Arc (deg) ........... portion du cercle (360 = cercle complet)
  Path Layer / Path Offset (%) ... tracé suivi (forme Path) ; anime l'offset pour faire défiler
  Orient Along Path ... chaque copie pointe dans la direction du tracé (source dessinée vers la droite)
Variations
  Random Position ..... dispersion aléatoire (px)
  Formation Spin ...... rotation continue de toute la formation (°/s) autour de Spin Axis
  Scale / Random Scale  échelle globale et variation (%)
  Random Rotation ..... rotation aléatoire de chaque copie (°)
  Clone Spin .......... chaque copie tourne sur elle-même (°/s)
  Face Camera ......... les copies regardent toujours la caméra active
  Random Opacity ...... variation d'opacité (%)
Forces
  Noise Amount / Frequency / Speed ... turbulence (px, détail, vitesse)
  Attractor ........... calque qui attire les copies (bouton « Ajouter un attracteur »)
  Attract Strength .... 0 à 100 % = attraction, valeur négative = répulsion
  Attract Radius ...... zone d'influence (px)
Apparition
  Reveal .............. active l'apparition progressive
  Reveal Order ........ Index, Reverse, Random, From Center (décalage par tranche de 100 px)
  Reveal Start / Stagger / Duration ... départ (s), décalage entre copies et durée (images)
  Reveal Distance ..... les copies arrivent depuis la profondeur (px, négatif = vers la caméra)
Couleur
  Colorize, Color Mode (Random / Gradient / Single), Color A, Color B
  Coche Coloriser dans le panneau (sous-onglet Couleur) : les réglages et l'effet Fond s'ajoutent
  tout seuls, même si l'option n'était pas cochée à la création. Single = toutes les copies en couleur A.
Seed .................. change tout l'aléatoire d'un coup

ONGLET « RÉPLICATEUR » (sélectionne le nul ou une copie)
  Copies + Mettre à jour : recrée les copies avec ce nombre (prérempli avec le nombre actuel). Si tu sélectionnes en plus d'autres
    calques, ils remplacent les sources.
  Ajouter un attracteur : crée un nul et le relie. Anime-le pour pousser les particules.
  Utiliser le tracé sélectionné : sélectionne le nul + un calque avec un masque ou un calque de forme.
    Le calque devient un guide (visible, non rendu).
  Désactiver / Activer les copies : coupe l'œil de toutes les copies (elles ne sont plus calculées
    du tout), ou le rallume. Marche aussi depuis la comp principale en sélectionnant une ou plusieurs
    précompos de réplicateurs. Attention : les calques discrets (shy) sont seulement rangés dans la
    timeline, ils restent calculés. Pour alléger un projet, c'est l'œil qu'il faut couper.
  Précomposer : range le réplicateur (nul, copies, cache, attracteur, tracé) dans sa propre
    composition, posée en 3D avec « Réduire les transformations » pour garder la caméra et les
    lumières de la comp principale. Coupe l'œil de cette précompo : plus rien n'est calculé.
    Avec Face Camera, une caméra liée à celle de la comp principale est ajoutée dans la précompo.
  Diagnostic : analyse le réplicateur et affiche un rapport à copier. S'il trouve des expressions
    cassées (nul renommé, erreur, expressions désactivées), le bouton Réparer recrée les copies.
  Supprimer le réplicateur : supprime les copies, le nul et l'attracteur, réaffiche les sources.

VITESSE
- Option « Accélérer : mettre texte et formes en cache » (cochée par défaut) : un calque texte ou de forme
  est copié dans une petite précomp recadrée « ... - Replicator cache ». After Effects le calcule une seule
  fois au lieu de le recalculer pour chaque copie. Le calque d'origine est masqué, puis réaffiché quand
  tu supprimes le réplicateur. Pour modifier le texte, ouvre la précomp de cache.
- Option « Accélérer : expressions seulement pour les réglages actifs » (cochée par défaut) : une copie
  ne reçoit que les expressions utiles. Avec les réglages par défaut, il reste 1 expression par copie
  (la position) au lieu de 7. La position reste toujours en direct : forme, spin, turbulence,
  attracteur, tracé.
  Depuis la 1.9, chaque expression ne contient plus que le code utile : celui de la forme choisie et
  des réglages actifs (turbulence, attracteur, apparition, rotation...). Le code est environ 3 fois
  plus court et chaque image se calcule plus vite. Quand tu changes un réglage depuis le panneau,
  les expressions des copies s'adaptent toutes seules. Si tu changes la forme ou actives un réglage
  directement dans les effets du nul, clique sur « Mettre à jour » : les expressions sont réécrites
  sur place, sans recréer les calques. « Appliquer le preset » le fait tout seul.
- En mode léger, Face Camera utilise l'orientation automatique d'After Effects (Calque > Transformer >
  Orientation automatique > Orienter vers la caméra) au lieu d'une expression. Si Face Camera est
  animé, l'expression est gardée. Change Face Camera depuis le panneau pour que les copies suivent.
- Un réplicateur créé avant le mode léger garde toutes ses expressions : clique sur « Mettre à jour »
  (mode léger coché) pour l'alléger. Le Diagnostic indique le nombre d'expressions par copie.
- Le moteur 3D classique est le plus rapide pour beaucoup de calques plats. Le script le propose à la
  création (Cinema 4D, ou 3D avancé à partir de 100 copies), et le Diagnostic a un bouton pour y passer.
- « Figer (lecture rapide) » : remplace les expressions des copies par des valeurs fixes, ou par des
  images clés sur la zone de travail pour ce qui bouge. La lecture devient fluide, mais les réglages du
  nul n'agissent plus. Règle la zone de travail avant de figer.
- Figer rapide avec rotation native : si la formation ne fait que tourner (Formation Spin, sans
  turbulence, sans attracteur, sans tracé, avec Face Camera, réglages de position non animés, nul à
  100 % d'échelle), Figer place les copies dans un nul « Replicator N Spin » qui tourne lui-même.
  Pendant la lecture, il ne reste qu'une expression en tout, au lieu d'une par copie et par image.
  Rotation formation et Axe de rotation restent réglables en direct depuis le panneau.
  Le script vérifie tout seul le sens de rotation. Sinon, Figer crée des images clés comme avant.
  Astuce : pour la galaxie, mets la turbulence à 0 pour profiter de ce mode.
- « Dégeler (réglages en direct) » : recrée les copies avec leurs expressions, sans changer leur nombre.
- Méthode conseillée : règle avec peu de copies, monte le nombre avec « Mettre à jour », puis fige pour
  la lecture et le rendu.
- La colorisation (effet Fond) et le flou de mouvement ajoutent un calcul par copie : ils sont décochés
  par défaut.
- Prévisualise en 1/2 ou 1/4 de résolution. Le moteur 3D classique est souvent plus rapide que le moteur
  3D avancé pour beaucoup de calques plats.

À SAVOIR
- Ne renomme pas le nul « Replicator N Control » : les expressions le retrouvent par son nom.
- Le nombre de copies est figé à la création : change-le avec « Mettre à jour ».
- Les balises [SimpleReplicator ...] dans les commentaires des calques servent au script : ne les efface pas.
- Au-delà de 300 à 400 copies, After Effects ralentit. Pour des précomps animées, une précomp
  source unique reste plus légère que plusieurs.
- Plusieurs réplicateurs peuvent cohabiter dans une même comp. Au-delà de quelques centaines de
  copies en tout, précompose chaque réplicateur et coupe l'œil de ceux sur lesquels tu ne travailles pas.

==================================================================== ENGLISH

PACK: Simple_Replicator.jsx (the script), Startup/ (optional auto open), PDF guides in French, English and
Spanish, and Simple_Replicator_Sample_Project.aep: one example of each preset, each in its own composition.

INSTALL: copy Simple_Replicator.jsx into .../Scripts/ScriptUI Panels/, restart After Effects,
then Window > Simple_Replicator.jsx.

USE: select one or more layers (footage, precomp, text, shape, 3D model), pick a shape and a number
of copies, click "Create replicator". Everything is then tweaked live in the effects of the
"Replicator N Control" null (see the list above, control names are in English).
PRESETS: pick one in the "Preset" list (fills in the shape and a suggested number of copies), then
Create, or "Apply preset" on the selected replicator: spinning galaxy, image wall, particle planet,
carousel, tornado, floating cloud, explosion, wave, path flow, swarm + attractor, reset.
A preset resets the other settings but keeps columns / rows, path, attractor, colors and Seed.
SPEED: "cache text and shapes" (on by default) renders a text / shape source once in a cropped precomp.
"Expressions only for active settings" (on by default): each copy only gets the expressions it needs, and
since 1.9 each expression only holds the code of the current shape and active settings (about 3x shorter).
Settings changed from the panel adjust the expressions by themselves; after changing the shape or turning
a setting on in Effect Controls, click Update (expressions are rewritten in place, no layer rebuild).
TURN COPIES OFF / ON: turns off the eye of every copy (no longer computed). Shy layers are only tucked away
in the timeline and are still computed: to lighten a project, turn the eye off.
PRECOMPOSE: moves the replicator (null, copies, cache, attractor, path) into its own 3D, collapsed
composition (main camera and lights still apply). Turn off its eye to pause the whole replicator.
With Face Camera, a camera linked to the main one is added inside.
"Freeze" bakes the copies into values or keyframes over the work area (smooth playback, settings
inactive); "Unfreeze" rebuilds the live expressions. Colorize and motion blur are off by default.
PANEL: three tabs (Create, Replicator, Settings) keep the window small.
AUTO OPEN: with the panel closed, clicking a replicator's null (or a copy) reopens it on the Settings tab.
Copy Startup/Simple_Replicator_AutoOpen.jsx into .../Scripts/Startup/ to have it from AE launch.
Turn it off with "Open this panel when I select a replicator" (Replicator tab).
COLOR: tick Colorize in the Color sub-tab at any time; Color Mode Single = every copy in Color A.
ORIENT ALONG PATH: with the Path shape, tick "Orient Along Path" so each copy points along the path.
LIVE SETTINGS: every null setting is also in the panel (tabs Animation, Shape, Variations, Reveal,
Color). Load the selected replicator, move a slider or type a value; ◆ adds a keyframe at the current
time, × removes the setting's keyframes.
Selected-replicator buttons: update the number of copies (other selected layers become the new
sources), add an attractor (negative strength = repel), use a selected mask / shape path, delete.
Do not rename the control null and keep the [SimpleReplicator ...] tags in layer comments.
